WHAT IS THIS?
=============
NanoWiki is a documentation tool with a small footprint, extreme containment, and maximum portability, even when segments are isolated from a comprehensive constellation. Each element is as self-sustained as possible.
Unlike most content managers, this documentation tool tries to embed as much content as possible into one file, not link resources, like images and/or supportive documents. Therefore these binary files are converted to text, using base64-conversion, then included into the content via straight HTML. The syntax for images, documents, and links is provided as templates, along with explanations and samples.
HOW DOES IT WORK?
=================
CHANGE THE MAIN TITLE...
of the documentation, by double-clicking on it.
ADD ARTICLES...
as needed, bring them into the right order, and save the whole page through the button in the upper left.
EDIT ARTICLES...
by double-clicking them. Then edit and save the whole page (again) with the button in the upper left. Get new images and documents posted, using the conversion tool in the [ADD] section.
NO FONT-SIZE, BOLD, ITALIC, TABLES - NOTHING???
Nope. Enjoy your own HTML-skills, almost everything is supported (but stay away from </textarea> and JavaScript). This is intended to be as simple and bare-bones as possible.
Templates for images and links (to files and pages) are included. Use CAPITALIZATION, +++ additional characters +++, and indentation for emphasis and organization. Worked for decades on a typewriter, works here too.
AND NO 'UNDO...'
In the text-box, right-click and choose UNDO, or press [CTRL]+[Z] / [CTRL]+[Y] for UNDO / REDO.
If you messed up completely, deleted something, open the original you should overwrite after editing in a separate window and get the content from there (open the editor with a double-click).
If you broke the system somehow, do not overwrite the previous version, simply re-load the page, and start over. If you overwrote the original already, get a backup.
MAKE AND KEEP BACKUPS, they compress nicely and fast. Disciplin, people, this is meant to be small, simple, fast, portable, and independent, not fool or vilain proof.
AND NO LOGIN/SECURITY...
Not needed, only you (or your people) have write access to the files. You can write anything on a paper copy, doesn't change the original, neither other people's copies.
HOW DO I SHARE MY DOCUMENTATION?
================================
Give others read access e.g. by posting the wiki on a web server or on a file-sharing platform, like Dropbox or Google Drive. Just find out how to "make file publicly accessible".
Web servers or fully addressible platforms are (only) required to provide cross-linked multi-topic documentation sites instead of single documentation pages.
Here is a handy notes file handler, extract directly into directory with documentation notes on a PHP-enabled web server.
ENJOY! - or improve...
Paste screenshots/images and type text
- From existing article, save all images
- In Wordpress, Main Menu [Posts], press button [Add New]
- Copy title
- In left side-bar, select Categories [v] Blog, set featured image, write excerpt (e.g. first paragraph)
+ Add block-type "Classic"
- In the block menu, select [Edit as HTML]
- In the source article, highlight and copy all content
+ Editor used is "CK-Editor", a visual HTML editor, easier to handle than the built-in Wordpress editor
- Paste content into editor
- Remove all images, page title and other irrelevant segments. Edit as needed.
- Convert all headlines ("H1, H2, H3...") to Paragraphs ("Normal" / "P")
+ Headlines will be reinstated in the Wordpress editor, for consistency
- Highlight all content
- Click function "Remove all <span> tags
+ This function will remove critical custom formatting (e.g. from Word articles)
=== SUBSECTION - ADDING IMAGES - START ===
- Switch to [Source] view
- Copy embedded-image sample, either from sampler or generator
- In the source code, identify target paragraph ('<p>') of image location (read clear text, not HTML)
- Place copied sample BEFORE paragraph start.
=== SUBSECTION - ADDING IMAGES - END ===
- ^ Repeat the subsection steps for ALL article images ^
- Switch back to visual mode with [Source] button
+ Sample images with sample quotes appear for all article images
- Switch back to [Source] view, copy all
- Paste code into Wordpress editor and switch to [Edit Visually]
- For all embedded sample images, select image, edit with [pen] button
- Select [Replace]
- Upload saved article image
- Replace with new, uploaded image
- Copy image caption from article
- Change caption. Make sure to paste as plain text.
- Change all article subtitles to boldface, 18pt font-size
- Add above article, create reference in separate paragraph, font-size:10pt + All linebreaks MUST be created with [Shift]+[Enter], to avoid splitting paragraphs
+ Make sure reference link opens in new window
- Save Draft
- Go back to Wordpress Pages, select new posting, [quick edit]
